Readme file for JabpLite version 1.63
=====================================
_rasekhoon.net

1. Programs for your mobile device
----------------------------------

a) Install the file JabpLite.jar which is located in the MIDP2.0 folder by following the instructions for installing Java MIDlets on your device.
b) A versions of JabpLite for Blackberry users included, ending in the suffix 'cod'.  Unpack the cod and alx files to the same directory.  These can be installed on your Blackberry device using Blackberry Desktop Manager - the alx file is the one which you should choose in BDM.  See more details below.

A version of JabpLite for MIDP1.0 devices is available from http://www.freepoc.org.


2. Over-the-air (OTA) installation via WAP
------------------------------------------

Some phones only allow installation of new programs over-the-air.  A versions of JabpLite is also hosted at GetJar.  Here are the instructions:

JabpLite: open wap.GetJar.com with your mobile > Quick Download > enter Quick Download Code 1060


3. Program for your PC
----------------------

If you want to transfer JabpLite's data to use on a PC, Mac or Linux, we recommend that you try Jabp which is located in the J2SE folder of this zip.


4. Upgrading from earlier versions of JabpLite
----------------------------------------------

The normal process for upgrading is to install the latest version of JabpLite directly over the previous version, while keeping user data.  However it has been reported that some recent Nokia devices (for example: E90, N75) fail to run new versions of JabpLite when installed directly over a previous version.  This problem happens intermittently.  At this point, we believe that it is due to a bug in Nokia's MIDlet installer.  If you experience this problem then first export your data to a memory card using JabpLite's export data function.  Then uninstall the old version of JabpLite and install the latest version.  Run the new version of JabpLite to create new data files.  Then use Extra Options > Sync/Import/Export > Import Data to import your backed-up data.

It is always a good idea to use JabpLite's export function to export your data before upgrading versions.  Devices *should* maintain the data, but sometimes don't - for example, some Blackberry devices.


5. Known problems
-----------------

a) JabpLite is over 100K in size.  On some older phones the maximum size for a Midlet is 64K, and these phones won't run the program.  However most new Java-enabled high-end phones should be able to run JabpLite.

b) Symbian phones such as the Sony Ericsson P800/P900/P910, the Nokia 6600/7610 etc do not centre the font correctly.  Workaround: set Preferences>Font Adjustment to 2 or 3.

c) The Sony Ericsson P800 does not display the screen height correctly.  Workaround: set Preferences>Height Adjustment to 29.

d) There are some bugs in the Java runtime on the Nokia 6600.  Consequently it is not possible to cancel certain dialog screens in JabpLite.  Workaround: close JabpLite and then re-open the program.

e) JabpLite will run on the Nokia 9300/9500 but it is very slow.  

f) Some Nokia S60 version 2 phones (eg. N70) need an extra setting for JabpLite to work.  Go to Application Manager, scroll down to JabpLite and select Options>Suite Settings.  Allow Edit User data.

g) Older Blackberry devices have a limit of 64K bytes on the Java RecordStore size.  In practice, this means that the total number of JabpLite transactions you can store on these Blackberrys is around 1000.  More modern devices (from the Blackberry Bold onwards) have a limit of 512K on the Java RecordStore size.

h) I have just updated my Nokia 5800 to the latest firmware (40.0.005). This firmware introduced kinetic scrolling across some parts of the operating system. Unfortunately, this has also introduced a bug into the Java runtime as follows. When using any of JabpLite's entry forms and selecting from a list (eg. selecting debit/credit, or selecting an account or a category) tapping on an item will change its colour from red to grey. Releasing the tap while the item is grey will cause the Java runtime to crash. This bug doesn't affect selecting items from JabpLite's menus.  A workaround is as follows. Tap the screen to select the item and, while continuing to press the screen, move slightly up or down until the item's colour changes back from grey to red. Now release the screen press and continue as normal.  I haven't checked but this bug may impact other S60 5th edition devices with recent firmwares. 


6. Installation to Blackberry devices
-------------------------------------

A number of users have reported difficulties installing to Blackberry devices using Blackberry Desktop Manager or using the Blackberry Browser.  If you are having difficulties and have access to a PC, then try the following.  

a) Download javaloader.exe from http://www.freepoc.org/download/javaloader.exe to a suitable directory on your PC.  Put JabpLite.cod in the same directory.

b) Connect your Blackberry to your PC via the USB lead

c) Open a DOS window and navigate to the directory where you downloaded javaloader.exe (eg. cd\my download directory)

d) Type javaloader -usb load JabpLite.cod

e) When asked, type your Blackberry password


7. Installation to Nokia S60 3rd edition & 5th edition devices
--------------------------------------------------------------

Please note the following: if you want JabpLite to check your password whenever it comes into focus (see Extra Options>Password) then you MUST install the program from JabpLite.jad and not JabpLite.jar.  This is because the jad file contains an extra Nokia-specific setting.


8. Nokia 5th edition devices touch-screen devices
-------------------------------------------------

By default all Java MIDlets, including JabpLite, will show an on-screen keypad.  If you want to reduce the space taken by the keypad then go to Settings>Application Mgr>Installed Apps.  Highlight JabpLite and choose Options>Suite settings.  Turn On-screen keyboard to Navig. keys only.

Alternatively to use full screen mode, set the on-screen keyboard to Off.  In JabpLite, go to Extra Options>Preferences and set Full Screen Views to Yes.  You will find that there are no soft key menus displayed (this is a 'feature' of S60 5th edition's Java implementation).  To call up JabpLite's menu, tap the screen and hold for 1 second.



I hope you find the programs useful.


Malcolm Bryant & FreEPOC
September 2004
Last updated 14 May 2010